Fill(Object[]) Method

In This Topic

Fills the System.Data.DataTable.Rows collection of the DbDataTable with rows from the data source using the parameter values passed in .

Syntax

Visual Basic
C#

'Declaration
 
Public Overloads Function Fill( _
   ByVal parameterValues() As Object _
) As Integer

public int Fill( 
   object[] parameterValues
)

Parameters

parameterValues: Used to fill the Devart.Data.SqlServer.SqlCommand.Parameters collection of the SelectCommand property.

Return Value

The number of rows successfully added to or refreshed in the DbDataTable. This does not include rows affected by statements that do not return rows.

Example

The following sample shows how to get data from a data source using Fill method with condition parameter value passed.

csharp

public void FillDataTable(DbDataTable myDataTable, IDbConnection myConnection, IDbDataParameter myParameter)
{
  myDataTable.Connection = myConnection;
  myDataTable.SelectCommand = myConnection.CreateCommand();
  myDataTable.SelectCommand.CommandText = "SELECT EmpNo, EName FROM Test.Emp WHERE DeptNo=:DeptNo";
  myParameter.ParameterName = "DeptNo";
  myDataTable.SelectCommand.Parameters.Add(myParameter);
  object[] myParamValue = new object[1];
  myParamValue[0] = 10;
  try
  {
    myDataTable.Fill(myParamValue);
    foreach(DataRow myRow in myDataTable.Rows)
    {
      foreach(DataColumn myCol in myDataTable.Columns)
      {
        Console.Write(myRow[myCol]+"\t");
      }
      Console.WriteLine();
    }
  }
  finally
  {
    myDataTable.Clear();
  }
}

Visual Basic

Public Sub FillDataTable(ByVal myDataTable As DbDataTable, ByVal myConnection As IDbConnection, ByVal myParameter As IDbDataParameter)
  myDataTable.Connection = myConnection
  myDataTable.SelectCommand = myConnection.CreateCommand()
  myDataTable.SelectCommand.CommandText = "SELECT EmpNo, EName FROM Test.Emp WHERE DeptNo=:DeptNo"
  myParameter.ParameterName = "DeptNo"
  myDataTable.SelectCommand.Parameters.Add(myParameter)
  Dim myParamValue() As Object = {10}
  Try
    myDataTable.Fill(myParamValue)
    Dim myRow As DataRow
    Dim myCol As DataColumn
    For Each myRow In myDataTable.Rows
      For Each myCol In myDataTable.Columns
        Console.Write(myRow(myCol) & Chr(9))
      Next myCol
      Console.WriteLine()
    Next myRow
  Finally
    myDataTable.Active = False
  End Try
End Sub

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

DbDataTable Class
DbDataTable Members
Overload List

Send Feedback